<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<HTML LANG="en">
<HEAD>
  <TITLE>SAP Java Connector 3.1 Installation</TITLE>
  <LINK REL="stylesheet" TYPE="text/css" HREF="./sap.css" TITLE="Style">
</HEAD>

<BODY BGCOLOR="white">

<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="800" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="10" CELLSPACING="0" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A HREF="intro.html"><FONT CLASS="NavBarFont1"><B>Home</B></FONT></TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"><FONT CLASS="NavBarFont1Rev"><B>Installation</B></FONT></A></TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A HREF="configuration.html"><FONT CLASS="NavBarFont1"><B>Configuration</B></FONT></A></TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A HREF="index.html" TARGET="_blank"><FONT CLASS="NavBarFont1"><B>API Documentation</B></FONT></A></TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A HREF="examples.html"><FONT CLASS="NavBarFont1"><B>Examples</B></FONT></A></TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A HREF="releasenotes.html"><FONT CLASS="NavBarFont1"><B>Release Notes</B></FONT></A></TD>
  </TR>
</TABLE>
</TD>

<TR><TD>
<HR>
<CENTER>
<h1>SAP Java Connector 3.1</h1>
</CENTER>
</TD>
</TR>

<tr><td><FONT SIZE="+1"><B>Installation</B></FONT></td></tr>

<tr><td>&nbsp;</td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>General information</b>
</td></tr>

<tr><td>
    The SAP Java Connector (JCo) 3.1 requires a Java Runtime Environment (JRE) version 8, 11 or 17.<br>
    Please see SAP note <a target="_blank" href="https://me.sap.com/notes/2786882">2786882</a> for
    a current and detailed list of supported platforms and Java runtime environments.
    The latest version of the SAP Java Connector can be downloaded from the SAP Support Portal at
    <a target="_blank" href="https://support.sap.com/jco">https://support.sap.com/jco</a>. There you will
    also find all available distribution packages for the various supported platforms and processors as
    well as the JCo 3.1 Documenation as PDF file.<br>
    Please note that you cannot use JCo 3.0 and JCo 3.1 together within a single process.
</td></tr>

<tr><td>&nbsp;</td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Platform independent remarks</b>
</td></tr>

<tr><td>
    When using JCo within a Java application server, you need to ensure that the JCo library is only loaded once.
    This is achieved best by putting the <code>sapjco3.jar</code> file into the system classpath or into the startup
    classpath of the application server itself. If JCo is loaded twice by different classloaders, this also results in
    the JCo native library being loaded twice, which will fail.<br/>
    As a consequence, an application must <b>never</b> package JCo within its own deployment unit, which means not to
    package the <code>sapjco3.jar</code> archive or its contents within an application's <code>*.war</code> or
    <code>*.ear</code> archive. The application has to presume that JCo is already installed and provided in the
    respective Java application server runtime.
</td></tr>

<tr><td>&nbsp;</td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Microsoft Windows</b>
</td></tr>

<tr><td>
    There are different distribution packages for various JRE versions and hardware processors available:
    <ul>
        <li><code>sapjco3-ntintel-3.1.8.zip</code> for a 32-bit JRE running on a 32- or 64-bit AMD or INTEL x86 processor
        <li><code>sapjco3-ntamd64-3.1.8.zip</code> for a 64-bit JRE running on a 64-bit AMD or INTEL x86 processor
    </ul>
    <em>Prerequisites:</em> JCo 3.1 requires the Microsoft Visual Studio 2013 C/C++ runtime libraries to be installed on
    the system. If not present, download and install the latest version of the
    "<a target="_blank" href="https://support.microsoft.com/en-us/help/4032938">Visual C++ 2013 Redistributable Package</a>"
    from Microsoft and choose the package, which corresponds to the used Locale and JVM bit-width (x64 for 64-bit or
    x86 for 32-bit).<br><p>
    <p>
    To install JCo for Windows unzip the appropriate distribution package into an own arbitrary directory
    <code>{sapjco3-install-path}</code>.<br>
    <p>
    <em>Note:</em> Do not copy the <code>sapjco3.dll</code> neither into the <code>{windows-dir}\system32</code>
    nor into the <code>{windows-dir}\SysWOW64</code> directory. This will break the operability of other JCo versions
    that are already installed on the same system. Furthermore you would risk that the current installation also would
    not work anymore, if the <code>sapjco3.dll</code> gets replaced in the respective Windows system directory in the
    future.
    <p>
    Then add <code>{sapjco3-install-path}</code> to the <code>PATH</code> environment variable.<br>
    Finally, add <code>{sapjco3-install-path}\sapjco3.jar</code> to your <code>CLASSPATH</code> environment variable.
</td></tr>

<tr><td>&nbsp;</td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Linux</b>
</td></tr>

<tr><td>
    There are different distribution packages for various hardware processors available:
    <ul>
        <li><code>sapjco3-linuxx86_64-3.1.8.tgz</code> for a 64-bit JRE running on a 64-bit AMD or INTEL x86 processor
        <li><code>sapjco3-linuxaarch64-3.1.8.tgz</code> for a 64-bit JRE running on a 64-bit ARM processor
        <li><code>sapjco3-linuxppc64le-3.1.8.tgz</code> for a 64-bit JRE running on a 64-bit IBM Power PC Little Endian processor
        <li><code>sapjco3-linuxs390x-3.1.8.tgz</code> for a 64-bit JRE running on a 64-bit IBM eServer zSeries processor
    </ul>
    To install JCo for Linux copy the appropriate distribution package into an own arbitrary directory
    <code>{sapjco3-install-path}</code>. Next, change to the installation directory:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;cd {sapjco3-install-path}&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    and extract the archive:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;tar zxvf sapjco3-linux*3.1.8.tgz&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    Then add <code>{sapjco3-install-path}</code> to the <code>LD_LIBRARY_PATH</code> environment variable.<br>
    Finally, add <code>{sapjco3-install-path}/sapjco3.jar</code> to your <code>CLASSPATH</code> environment variable.
</td></tr>

<tr><td>&nbsp;</td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>IBM AIX</b>
</td></tr>

<tr><td>
    The following distribution package is available:
    <ul>
        <li><code>sapjco3-rs6000_64-3.1.8.tgz</code> for a 64-bit JRE running on a 64-bit IBM RS/6000 processor
    </ul>
    To install JCo for IBM AIX copy the distribution package into an own arbitrary directory
    <code>{sapjco3-install-path}</code>. Next, change to the installation directory:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;cd {sapjco3-install-path}&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    and extract the archive:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;gunzip sapjco3-rs6000*3.1.8.tgz&nbsp;&nbsp;&nbsp;</code><i>[return]</i><br>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;tar xvf sapjco3-rs6000*3.1.8.tar&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    Then add <code>{sapjco3-install-path}</code> to the <code>LIBPATH</code> environment variable.<br>
    Finally, add <code>{sapjco3-install-path}/sapjco3.jar</code> to your <code>CLASSPATH</code> environment variable.
</td></tr>

<tr><td>&nbsp;</td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>IBM i (OS/400 PASE)</b>
</td></tr>

<tr><td>
    The following distribution package is available:
    <ul>
        <li><code>sapjco3-as400_pase_64-3.1.8.tar</code> for a 64-bit JRE running on a 64-bit IBM i system
    </ul>
    To install JCo for IBM i copy the distribution package into an own arbitrary directory
    <code>{sapjco3-install-path}</code>. Next, open a QP2TERM session and change to the installation directory:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;cd {sapjco3-install-path}&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    and extract the archive:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;tar -xvf sapjco3-as400_pase_64-3.1.8.tar&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    Then add some environment variables as described in note
    <a target="_blank" href="https://me.sap.com/notes/1269638">1269638</a> according to the used JVM.<br>
    Finally, add <code>{sapjco3-install-path}/sapjco3.jar</code> to your <code>CLASSPATH</code> environment variable.
</td></tr>

<tr><td>&nbsp;</td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>IBM z/OS</b>
</td></tr>

<tr><td>
    The following distribution package is available:
    <ul>
        <li><code>sapjco3-os390_64-3.1.8.tgz</code> for a 64-bit JRE running on a 64-bit PPC processor
    </ul>
    To install JCo for IBM z/OS copy the distribution package into an own arbitrary directory
    <code>{sapjco3-install-path}</code>. Next, change to the installation directory:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;cd {sapjco3-install-path}&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    and extract the archive:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;gunzip sapjco3-os390*3.1.8.tgz&nbsp;&nbsp;&nbsp;</code><i>[return]</i><br>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;tar xvf sapjco3-os390*3.1.8.tar&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    Finally, add <code>{sapjco3-install-path}/sapjco3.jar</code> to your <code>CLASSPATH</code> environment variable.
    <p>After the installation you should tag all examples and documentation files being ASCII: <br>
    Change to the examples directory and execute<br>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;chtag -tc ISO8859-1 *.java&nbsp;&nbsp;&nbsp;</code><i>[return]</i><br>
    Change to the docs directory and execute<br>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;chtag -R -tc ISO8859-1 *.html&nbsp;&nbsp;&nbsp;</code><i>[return]</i><br>
</td></tr>

<tr><td>&nbsp;</td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>HP-UX</b>
</td></tr>

<tr><td>
    The following distribution package is available:
    <ul>
        <li><code>sapjco3-hpia64-3.1.8.tgz</code> for a 64-bit JRE running on a 64-bit INTEL Itanium processor
    </ul>
    To install JCo for HP copy the distribution package into an own arbitrary directory
    <code>{sapjco3-install-path}</code>. Next, change to the installation directory:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;cd {sapjco3-install-path}&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    and extract the archive:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;gunzip sapjco3-hp*3.1.8.tgz&nbsp;&nbsp;&nbsp;</code><i>[return]</i><br>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;tar xvf sapjco3-hp*3.1.8.tar&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    Then add <code>{sapjco3-install-path}</code> to the <code>SHLIB_PATH</code> environment variable.<br>
    Finally, add <code>{sapjco3-install-path}/sapjco3.jar</code> to your <code>CLASSPATH</code> environment variable.
</td></tr>

<tr><td>&nbsp;</td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Oracle Solaris (SunOS)</b>
</td></tr>

<tr><td>
    There are different distribution packages for various hardware processors available:
    <ul>
        <li><code>sapjco3-sun_64-3.1.8.tgz</code> for a 64-bit JRE running on a 64-bit SUN SPARC processor
        <li><code>sapjco3-sunx86_64-3.1.8.tgz</code> for a 64-bit JRE running on a 64-bit AMD or INTEL x86 processor
    </ul>
    To install JCo for SUN Solaris copy the appropriate distribution package into an own arbitrary directory
    <code>{sapjco3-install-path}</code>. Next, change to the installation directory:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;cd {sapjco3-install-path}&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    and extract the archive:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;gunzip sapjco3-sun*3.1.8.tgz&nbsp;&nbsp;&nbsp;</code><i>[return]</i><br>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;tar xvf sapjco3-sun*3.1.8.tar&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    Then add <code>{sapjco3-install-path}</code> to the <code>LD_LIBRARY_PATH</code> environment variable.<br>
    Finally, add <code>{sapjco3-install-path}/sapjco3.jar</code> to your <code>CLASSPATH</code> environment variable.
</td></tr>


<tr><td>&nbsp;</td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Apple macOS</b>
</td></tr>

<tr><td>
    There are different distribution packages for various hardware processors available:
    <ul>
        <li><code>sapjco3-darwinarm64-3.1.8.zip</code> for a 64-bit JRE running on a 64-bit ARM processor
        <li><code>sapjco3-darwinintel64-3.1.8.zip</code> for a 64-bit JRE running on a 64-bit INTEL x86 processor
    </ul>
    To install JCo for Apple macOS copy the appropriate distribution package into an own arbitrary directory
    <code>{sapjco3-install-path}</code>. Next, change to the installation directory:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;cd {sapjco3-install-path}&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    and extract the archive:<p>
    <code>&nbsp;&nbsp;&nbsp;&nbsp;unzip sapjco3-darwin*3.1.8.zip&nbsp;&nbsp;&nbsp;</code><i>[return]</i><p>
    Then add <code>{sapjco3-install-path}</code> to the <code>DYLD_LIBRARY_PATH</code> environment variable.<br>
    Finally, add <code>{sapjco3-install-path}/sapjco3.jar</code> to your <code>CLASSPATH</code> environment variable.
</td></tr>

<TR>
<TD>
<hr>
</TD>
</TR>
<TR>
<TD>
<i>Copyright &#169; 2008-2023 SAP SE. All Rights Reserved.</i>
</TD>
</TR>
</BODY>
</HTML>
